rectangle
Type
property
Summary
Specifies the area within which an object is drawn.
Syntax
set the rectangle of <object> to <left>, <top>, <right>, <bottom>
get the [effective] rectangle of <object>
Description
Use the rectangle property to find out how far an object extends, to move it, or to resize it.
The four items of an object's rectangle describe the object's left, top, right, and bottom edges:
- The left is the number of pixels between the left edge of the stack window and the leftmost pixel of the object.
- The top is the number of pixels between the top edge of the stack window and the topmost pixel of the object.
- The right is the horizontal distance in pixels between the left edge of the stack window and the rightmost pixel of the object.
- The bottom is the vertical distance in pixels between the top edge of the stack window and the bottommost pixel of the object.
The sides of an object's rectangle specify the lines between pixels, not the pixels themselves. For example, if an object's rectangle is "0,0,2,2", the object includes four pixels, starting at the top left corner of the card. In the case of a line or curve graphic, the graphic's rectangle encloses all the pixels in the graphic's points property without touching any of them.
If the object is a stack, its rectangle is relative to the left and top of the screen, rather than the left and top of the stack window.
The first two items of a card's rectangle are always zero. The third item is the height of the card, and the fourth is the width of the card.
The rectangle of a graphic is drawn around all its points without touching them. (Usually, this makes no difference, but in some circumstances where you need to place a graphic's vertex precisely with respect to another object's rectangle, you may need to take this into account.)
If you specify the effective keyword, the rectangle includes the outline added by the showFocusBorder property. It also includes the heavy outline added to the defaultButton. If the showFocusBorder of the object is false, or the object is not currently focused, the effective rectangle is the same as the rectangle.
As of LiveCode 6.0 the effective rect property of stacks returns the rect of the given stack with its decorations and frame taken into account. The effective rect of a stack can also be set. Here, the rect of the frame of the stack will be set appropriately before setting the rect of the stack. The effective rect of a stack only returns valid values if the stack is open (visible or invisible) so that a window frame applicable to the OS has been created for it.
Examples
set the rectangle of button "Tangle" to 20,20,45,200
set the rectangle of group 1 to the rectangle of this card
Related
command: revChangeWindowSize, export snapshot, crop
glossary: object, property, keyword, focus, vertex, stack window, integer
message: moveStack
object: graphic
property: bottom, topRight, pixels, points, defaultButton, width, showFocusBorder, height, backSize, orientation, margins, windowManagerPlace, overflowRect
Compatibility and Support
Introduced
LiveCode 1.0
OS
mac
windows
linux
ios
android
Platforms
desktop
server
mobile